HHLib Programming Library for HydraHarp 400 
Version 3.0.0.4
PicoQuant GmbH - April 2022



Introduction

The HydraHarp 400 is a TCSPC system with USB interface. 
The system requires a 686 class PC with USB 2.0/3.0 host controller,
4 GB of memory and at least a 1.5 GHz dual core CPU.
The programming library is a DLL with demos for various programming 
languages. Please refer to the manual (PDF) for instructions. 
There are versions for Windows and Linux.


Disclaimer

PicoQuant GmbH disclaims all warranties with regard to this software 
and associated documentation including all implied warranties of 
merchantability and fitness. In no case shall PicoQuant GmbH be 
liable for any direct, indirect or consequential damages or any material 
or immaterial damages whatsoever resulting from loss of data, time 
or profits arising from use or performance of this software.


License and Copyright Notice

With the HydraHarp hardware product you have purchased a license to use 
the HydraHarp software. You have not purchased the software itself. 
The software is protected by copyright and intellectual property laws. 
You may not distribute the software to third parties or reverse engineer, 
decompile or disassemble the software or part thereof. You may use and 
modify demo code to create your own software. Original or modified demo 
code may be re-distributed, provided that the original disclaimer and 
copyright notes are not removed from it. Copyright of the manual and 
on-line documentation belongs to PicoQuant GmbH. No parts of it may be 
reproduced, translated or transferred to third parties without written 
permission of PicoQuant GmbH. 


Trademark Disclaimer

HydraHarp, PicoHarp, TimeHarp and NanoHarp are registered trademarks 
of PicoQuant GmbH. Other products and corporate names appearing in the 
product manuals or in the online documentation may or may not be registered 
trademarks or copyrights of their respective owners. They are used only 
for identification or explanation and to the owner's benefit, without 
intent to infringe.


Acknowledgements

The HydraHarp programming library for Linux uses Libusb to access the 
HydraHarp USB devices. Libusb is licensed under the LGPL which allows a 
fairly free use even in commercial projects. For details and precise terms 
please see http://libusb.info. In order to meet the license requirements a 
copy of the LGPL as appliccable to Libusb is provided as part of the 
distribution archive. The LGPL does not apply to the HydraHarp programming 
library as a whole. For this version of the library we also gratefully 
acknowledge the use of GNU/Linux as a development platform, as well as 
using the Tux logo (thanks to Larry Ewing, lewing@isc.tamu.edu and The GIMP) 
on the titlepage of the manual.


What's new in version 3.0.0.4

- Provides some more advanced demos in C, C#, Python and Delphi, 
  most importantly some new demos for instant processing of TTTR data


What was new in version 3.0.0.3

Version 3.0.0.3 is a bugfix release addressing the following issues: 
- Fixes a bug where warnings were wrong or missing upon change of 
  measurement modes.  
- Now uses Libusb 1.0 instead of Libusb 0.1
- Includes updated demos.
- Dropping support for 32-bit as major Linux distros do
Please read the notes for version 2.0 below if you are upgrading 
from a library version prior to 2.0! 


What was new in version 3.0.0.2

Version 3.0.0.2 is a bugfix release addressing the following issues:
- Fixes a firmware bug in continuous mode where the hardware controlled 
  start of a measurement did not work properly in repetition.
- Fixes a bug where the library routine HH_SetOffset was not working 
  properly in T3 mode. 
- Fixes a bug where the library routine HH_GetWarnings was giving false
  warnings at the first call after initialization.
- Fixes several documentation errors and omissions.
- Includes new and improved demos.


What wass new in version 3.0.0.1

Version 3.0.0.1 fixes an incompatibility with USB 3.0 ports of Intel Z97 
chipsets. The demos remain unchanged from version 3.0.0.0. 
Please read the notes for version 2.0 below if you are upgrading 
from a library version prior to 2.0! 


Changes in Version 3.0 

Version 3.0 was an improvement release that supersedes version 2.x. 
Please upgrade if you installed 2.x. If you are still using v 1.x 
please read the notes below very carefully.


Important Changes in Version 2.0 versus 1.x

- Supports HydraHarp devices with USB 3.0 interface 
- Supports time bin widths of up to 33.5 s and histogram time spans 
  up to 2.2 seconds. 
- Supports compressed TTTR overflow records for file size reduction at 
  low count rates. 
- Fixes some minor bugs. 
- NOTE 1: Version 2.0 requires a firmware update of the HydraHarp device. 
  The HydraHarp software for Windows can perform this update when it is 
  first started.
- NOTE 2: This version has a new TTTR data format. 

IMPORTANT! The firmware update requirement has consequences that you 
must observe:

1. Once the update is performed you will no longer be able to use any 
   HydraHarp software prior to version 2.0.
2. Custom software you may have written for file import will require 
   minor adaptions for version 2.0.
3. You will no longer be able to use custom software based on HHLib.dll 
   prior to version 2.0.
4. Custom DLL-based software you may have written will require minor 
   adaptions for version 2.0.
5. In case of a power failure or computer crash during the update the 
   device may become inoperational.
6. Reverting to old firmware or repairing a disrupted update requires 
   a return to factory and may incur costs.



Contact and Support

PicoQuant GmbH
Rudower Chaussee 29
12489 Berlin, Germany
Phone +49 30 1208820-0
Fax   +49 30 1208820-90
email info@picoquant.com
